Creating an AccessKey In CDNetworks

This guide describes the CDNetworks products, features, and configuration that must be enabled so IO River can integrate, manage, and validate your CDN setup.

NOTE: Some of these cannot be set with CDNetworks support.

Required CDNetworks Products and Permissions

The following products or capabilities must be available in your CDNetworks account.

1. Dynamic Web Acceleration
2. Open API access
3. Certificate Management
4. Content Management
5. Log Download

Required API Endpoints

Your API key must be authorized to access the following endpoints.

API Endpoint	API Names
/api/certificate	CreateCertificateV2, DeleteCertificate, GetCertificateV2, UpdateCertificateV2
/api/ssl/certificate	QueryCertificate, QueryCertificateList
/api/domain/terraform	UpdateDomainForTerraform
/api/domain	DeleteApiDomainService, QueryApiDomainListService, EditDomainConfig, GetBasicConfigurationOfDomain
/api/domain/domain-and-alias	QueryCdnwAliasDomainsForWplus
/api/domain-alias	DeleteDomainAlias
/api/domain/alias	AddDomainAlias
/cdnw/api/domain	AddCdnDomain, UpdateCdnDomain, QueryCdnDomainService
/api/config/ipversion	UpdateIpVersionConfig
/api/config/visitcontrol	EditAntiHotlinkingConfig, QueryAntiHotlinkingConfig
/api/config/compresssetting	UpdateCompressionConfig, QueryCompressionConfig
/api/config/originrulesrewrites	EditOriginUriAndHost, QueryOriginUriAndHost
/api/config/websocket	EditWebsocketConfig, QueryWebsocketConfig
/api/content/regular-url/purge	-
/api/report/domainflow	-
/api/report/domainflow/dwa	QueryTrafficForMultiDomain
/api/report/domainhit	-
/api/report/request/hit-ratio/total	QueryRequestHitRatio
/api/report/request/country	ReportUserRequestCountryService
/api/report/status-code	QueryStatusCodeDistribution
/api/report/log/downloadLink	QueryDomainLogDownloadAddress

Required Traffic Handling Configuration

The following behavior must be enabled on the delivery service used by IO River:

1. Real client IP forwarding enabled
2. X-Forwarded-For header preserved from client to origin

These settings are required for accurate client attribution, analytics, and troubleshooting.

Required Log Collection Configuration

Configure CDNetworks logging with the following values:

1. Log format: cdnw_json_1
2. Log merge granularity: 5 minutes
3. Merge delay: 5 minutes

Required Log Fields (cdnw_json_1)

{
  "Timestamp": "%unix_time",
  "ResponseBytes": "%size",
  "RequestBytes": "%upsize",
  "StatusCode": "%code",
  "Path": "%quri",
  "QueryParams": "%query",
  "Domain": "%ord_channel",
  "Referer": "%referer",
  "GeoLocation": "%country",
  "City": "%host_city_iso",
  "HttpVersion": "%rp",
  "UserAgent": "%ua",
  "IsCached": "%cache",
  "Method": "%method",
  "XForwardedFor": "%X-Forwarded-For",
  "TimeTaken": "%msec-dltime",
  "CurrentSampleRate": "%ratio_default",
  "Cookie": "%cookie",
  "ServerIP": "%cdnip",
  "ClientASN": "%asnum",
  "ContentEncoding": "%sent_http_content_encoding",
  "ClientASNName": "%asname",
  "ResponseContentType": "%Content-Type",
  "TurnAroundTime": "%{tcptf_withdefault}"
}